Inside Macintosh: QuickDraw GX Printing Extensions and Drivers /

Chapter 4 - Printing Messages / Printing Messages Reference

Printing Messages / PostScript Imaging Messages

GXPostScriptDoDocumentTrailer

QuickDraw GX sends the GXPostScriptDoDocumentTrailer message to generate the document trailer that is appended to the end of the PostScript program for a document. You can override the GXPostScriptDoDocumentTrailer message to perform an action after all pages in a document have been imaged. Your override of the GXPostScriptDoDocumentTrailer message must match the following formal declaration:

OSErr MyPostScriptDoDocumentTrailer (
                        gxPostScriptImageDataHandle hImageData);

hImageData

A handle to the PostScript imaging system structure.

function result

An error code. The value noErr indicates that the operation was successful.

DESCRIPTION

QuickDraw GX sends the GXPostScriptDoDocumentTrailer message to generate the document trailer after terminating the imaging of a document. It sends this message during its default implementation of the GXImageDocument message, after all the pages of the document have been imaged.

The default implementation of this message changes the display in the desktop printer window to reflect the number of pages printed for the document.

SPECIAL CONSIDERATIONS

You always forward the GXPostScriptDoDocumentTrailer message to allow other message handlers the opportunity to perform document-termination tasks.

RESULT CODES

gxSegmentLoadFailedErr	A required code segment could not be found, or there was not enough memory to load it.
gxPrUserAbortErr	The user has canceled printing.

The default implementation of the GXPostScriptDoDocumentTrailer message can also return the communications errors that are listed in Table 4-2 on page 4-42.

SEE ALSO

The GXImageDocument message is described on page 4-93.

The PostScript imaging system structure is described on page 4-26.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help